Carrossel

O Bloco de "Carrossel" do Digital Contact Bots permite exibir conteúdos em formato de carrossel deslizável, com até 15 cards por bloco. Esse recurso é útil para apresentar produtos, serviços ou opções interativas ao usuário.

Configurações do bloco "Carrossel" no Digital Contact Bots

O Bloco de "Carrossel" pode ser encontrado no menu lateral, dentro da seção “Texto e Menu”.

Ao ser inserido no fluxo, ele aparecerá assim:

Após ser configurado, o bloco assume a seguinte aparência:

O menu lateral do Bloco de Carrossel contém os seguintes campos:

Ao expandir a opção de ação, serão exibidos os botões.

Título do Carrossel: texto exibido acima dos cards no WhatsApp. Pode ter até 1.024 caracteres. Para outros canais esse campo é ignorado. Caso o campo seja deixado em branco em um bot com canal WhatsApp, o sistema utiliza o título do próprio bloco como fallback; se o título do bloco também estiver vazio, um ponto (.) é enviado automaticamente para satisfazer o requisito da API.

Cada carrossel pode conter até 15 cards, e cada card inclui:

• Imagem: suporta arquivos de até 15 MB. Pode ser adicionada arrastando o arquivo ou selecionando através do botão.
• Título: limite de 13 caracteres na exibição (caso ultrapasse, será exibido com reticências “…”). Para o WhatsApp, o título é inserido no corpo do card junto com a descrição — veja detalhes na seção Comportamento no WhatsApp.
• Descrição: limite de 600 caracteres. Para o WhatsApp, o total de Título + Descrição deve respeitar o limite — veja detalhes na seção Comportamento no WhatsApp.
• Botões: até 4 botões por card. Cada botão pode conter até 20 caracteres. Os botões podem ser configurados com os seguintes destinos:
  • 1. URL: limitado a 200 caracteres.
  • 2. Telefone: composto pelo DDD e número
  • 3. Bloco: permite direcionar o usuário para outro bloco do fluxo.
  • 4. Copiar: permite que o usuário copie um texto ou o conteúdo de uma variável.

Após configurar o fluxo, a exibição fica assim:

Para configurar um botão:

1. clique no botão desejado.
2. edite o nome e defina o destino (URL, telefone, bloco ou copiar).

O nome do botão e o destino configurado aparecem ao lado de “Destino >”, facilitando a identificação:

Para adicionar um novo card, clique no botão ”+” ao lado da imagem:

Quando há mais de um card, o botão de excluir card fica disponível, permitindo remover um item caso necessário:

A navegação entre os cards pode ser feita através das setas laterais:

Após as configurações, é assim que o carrossel se parecerá no WebChat e no WhatsApp:

---

Comportamento no WhatsApp

O bloco de Carrossel funciona no canal WhatsApp exclusivamente com o provedor Sendfy Cloud. Abaixo estão as regras e limitações específicas desse canal.

Título do Carrossel

No WhatsApp, o campo Título do Carrossel é obrigatório, ele corresponde ao texto da mensagem principal exibida acima dos cards. Configure-o no campo "Título do Carrossel" no painel do bloco.

Caso o campo seja deixado em branco, o sistema aplica o seguinte fallback em ordem: Usa o título do bloco (campo "Título" no cabeçalho do bloco no builder), se preenchido. Se o título do bloco também estiver vazio, envia um ponto (.) automaticamente.

Número de cards

O WhatsApp exige no mínimo 2 e no máximo 10 cards por carrossel (limitação da Meta). Se o bloco tiver fora desse intervalo, o carrossel não será enviado.

Consistência de botões entre cards

Todos os cards do carrossel devem ter o mesmo tipo e a mesma quantidade de botões. Caso haja inconsistência, o carrossel é bloqueado e a conversa é encerrada automaticamente. O builder exibe um aviso quando o bot possui o canal WhatsApp configurado.

Tipos de botão suportados no WhatsApp

No WhatsApp, apenas dois tipos de destino de botão funcionam:

Tipo no builder	Como é enviado ao WhatsApp	Observação
URL	cta_url	Somente 1 botão URL por card (os demais são ignorados); rótulo: máx. 20 caracteres
Bloco	quick_reply	Múltiplos botões permitidos; rótulo: máx. 20 caracteres

Todos os cards devem usar o mesmo tipo de botão (todos URL ou todos Bloco).

Título e Descrição do card no WhatsApp

A soma de Título + Descrição do card deve ter no máximo 160 caracteres no total (limitação da Meta). Conteúdo que ultrapassar esse limite será truncado na entrega.